home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload Trio 2 / Shareware Overload Trio Volume 2 (Chestnut CD-ROM).ISO / dir27 / calctool.zip / CALCTOOL.MAN < prev    next >
Text File  |  1994-02-08  |  17KB  |  529 lines
  1.  
  2.  
  3.  
  4. CALCTOOL(1L)      MISC. REFERENCE MANUAL PAGES       CALCTOOL(1L)
  5.  
  6.  
  7.  
  8. NAME
  9.      calctool - a simple calculator
  10.  
  11. SYNOPSIS
  12.      calctool [ -a _a_c_c_u_r_a_c_y ] [ -d _d_i_s_p_l_a_y ] [ -g _g_e_o_m_e_t_r_y ] [ -h
  13.      _h_e_l_p_f_i_l_e ] [ -i ] [ -v ] [ -Wi ] [ -Wp _x _y ] [ -WP _x _y ]
  14.  
  15. DESCRIPTION
  16.      _C_a_l_c_t_o_o_l is  a  simple  calculator.  It  contains  graphical
  17.      interfaces for MGR, NeWS, SunView, X11 and XView, as well as
  18.      being able to function on normal display terminals  using  a
  19.      termcap interface. It can receive input via the keyboard, or
  20.      the mouse where applicable. Each calculator button  has  two
  21.      functions associated with it.
  22.  
  23.      Internal arithmetic is done with double  precision  floating
  24.      point  numbers.   Accuracy can be adjusted from zero to nine
  25.      numeric  places  in  fixed  notation,  but  numbers  can  be
  26.      displayed  in  scientific  notation  as well. The calculator
  27.      reverts to scientific notation when  the  number  is  larger
  28.      than  the display would allow in fixed notation. The base of
  29.      operation can be changed between binary, octal, decimal  and
  30.      hexidecimal.  Numbers are initially displayed in fixed nota-
  31.      tion to two numeric places, in the decimal base.
  32.  
  33.      You can use the SunView / XView _P_u_t and _G_e_t function keys in
  34.      conjunction  with  the  numeric display to store or retrieve
  35.      characters from the text shelf. The previous  digit  entered
  36.      can be removed and the whole display cleared.
  37.  
  38.      There are ten memory registers; numbers can be retrieved  or
  39.      stored  in  these locations, and arithmetic can be performed
  40.      upon register contents.
  41.  
  42.      The display windows contains  the  current  numerical  value
  43.      plus the current base and trigonometric type. There are also
  44.      indicators which show if the hyperbolic and inverse function
  45.      switches  are  set, and which numerical mode is currently in
  46.      operation. If an operation needing more than  one  numerical
  47.      input is partially complete, the operation is also displayed
  48.      in this window as a reminder.
  49.  
  50.      The calculator has arithmetical, logical and trigonometrical
  51.      functions.   These  are  grouped together and color coded on
  52.      color workstations.
  53.  
  54.      With the SunView and XView versions, there  is  support  for
  55.      popup  menus  with the right mouse button. Only certain but-
  56.      tons which have multiple options have  this  ability.  These
  57.      are the ACC, CON, EXCH, FUN, <, >, RCL and STO keys.
  58.  
  59.  
  60.  
  61.  
  62.  
  63. Sun Release 4.1   Last change: 13 December 1989                 1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. CALCTOOL(1L)      MISC. REFERENCE MANUAL PAGES       CALCTOOL(1L)
  71.  
  72.  
  73.  
  74.      Online help is provided via a help button.  Select this but-
  75.      ton,  and  then  the  function you wish to be described. The
  76.      calctool windows can be redrawn by  typing  ^L  (control-l).
  77.      This  is very useful with the tty version after somebody has
  78.      written system messages all over your screen.
  79.  
  80.      On startup, _c_a_l_c_t_o_o_l will look for a ._c_a_l_c_t_o_o_l_r_c file in the
  81.      users'  home  directory. This file allows the user to define
  82.      their own constants and function definitions. It then  looks
  83.      for  a  ._c_a_l_c_t_o_o_l_r_c  file in the current directory. With the
  84.      ._c_a_l_c_t_o_o_l_r_c file, there  are  currently  four  valid  record
  85.      types; comments, constants, function definitions and initial
  86.      memory register values.
  87.  
  88.      Lines starting with  a  '#'  are  treated  as  comments  and
  89.      ignored.
  90.  
  91.      Lines starting with 'c' or  'C'  in  the  first  column  are
  92.      definitions  for constants. The cC is followed by a digit in
  93.      the range 0-9, then a space.  This is followed by  a  number
  94.      in  fixed  or  scientific  notation.  Following  this  is an
  95.      optional comment, which if found, will be used in the  popup
  96.      menu  for  the  constants.  If  the comment is present, then
  97.      there must be at  least  one  space  between  this  and  the
  98.      preceding number.
  99.  
  100.      Lines starting with 'f' or  'F'  in  the  first  column  are
  101.      definitions  for functions. The fF is followed by a digit in
  102.      the range 0-9, then a space. This is followed by a  function
  103.      definition.  Following this is an optional comment, which if
  104.      found, will be used in the popup menu for the functions.  If
  105.      the  comment  is  present,  then  there must be at least one
  106.      space between this and the preceding function definition.
  107.  
  108.      Lines starting with 'r' or  'R'  in  the  first  column  are
  109.      definitions  for  the  initial contents of the memory regis-
  110.      ters. The rR is followed by a digit in the range 0-9, then a
  111.      space.  This  is followed by a number in fixed or scientific
  112.      notation. The rest of the line is ignored.
  113.  
  114.      All other lines are ignored. There  should  be  no  embedded
  115.      spaces  in the function definitions. Whenever a backslash is
  116.      found, this and the following character  signify  a  control
  117.      character, for example \g would be ASCII 7.
  118.  
  119. OPTIONS
  120.      -a _a_c_c_u_r_a_c_y
  121.           Initial number of significant  digits  displayed.  This
  122.           value  must  be  in the range 0 to 9. If not specified,
  123.           this value defaults to 2.
  124.  
  125.      -d _d_i_s_p_l_a_y
  126.  
  127.  
  128.  
  129. Sun Release 4.1   Last change: 13 December 1989                 2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. CALCTOOL(1L)      MISC. REFERENCE MANUAL PAGES       CALCTOOL(1L)
  137.  
  138.  
  139.  
  140.           Used with the X11 variant of calctool to give a display
  141.           type.
  142.  
  143.      -g _g_e_o_m_e_t_r_y
  144.           Used with the X11 variant of calctool to give  geometry
  145.           information.
  146.  
  147.      -h _h_e_l_p_f_i_l_e
  148.           Use an alternate helpfile.
  149.  
  150.      -i   Invert the calctool window before  displaying  it.  For
  151.           use by people who started their graphics environment in
  152.           inverse mode.
  153.  
  154.      -v   Print the version number of this release of  the  calc-
  155.           tool program.
  156.  
  157.      -Wi  Start the calctool program up in iconic  form.  SunView
  158.           automatically uses this flag, but the NeWS version will
  159.           also.
  160.  
  161.      -Wp _x _y
  162.           Start the open window position at _x _y
  163.  
  164.      -WP _x _y
  165.           Start the icon position at _x _y
  166.  
  167. CALCULATOR BUTTONS
  168.      [Keyboard equivalents appear in brackets]
  169.  
  170.   Numerical Keys [ 0-9 a-f . = <RETURN> ].
  171.      Enter a digit (decimal digits 0-9 or hexidecimal digits A-F)
  172.      in  the  display.   The . acts as the decimal point and = is
  173.      used for completion of numerical entry (<RETURN> can be also
  174.      be used from the keyboard to terminate numerical entry).
  175.  
  176.   Arithmetical Operations [ + - x X * / ].
  177.      Perform an arithmetical operation using the  previous  entry
  178.      and the next entry as operands.  Addition, subtraction, mul-
  179.      tiplication and division are denoted by the buttons +, -,  x
  180.      and / respectively (the keyboard keys * and X are synonymous
  181.      with x for multiplication).
  182.  
  183.   Base Changes.
  184.      BIN  [ B ]        Change display base to binary (maximum: 32
  185.                        digits).
  186.  
  187.      OCT  [ O ]        Change display base to octal (maximum:  15
  188.                        digits). are allowed.
  189.  
  190.      DEC  [ D ]        Change display base to  decimal  (default;
  191.                        maximum: 12 digits).
  192.  
  193.  
  194.  
  195. Sun Release 4.1   Last change: 13 December 1989                 3
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. CALCTOOL(1L)      MISC. REFERENCE MANUAL PAGES       CALCTOOL(1L)
  203.  
  204.  
  205.  
  206.      HEX  [ H ]        Change display base to  hexidecimal  (max-
  207.                        imum: 12 digits).
  208.  
  209.   Trigonometric Unit Changes.
  210.      DEG  [ ^d ]       Change  current  trigonometrical  base  to
  211.                        degrees.
  212.  
  213.      RAD  [ ^r ]       Change the current trigonometrical base to
  214.                        radians.
  215.  
  216.      GRAD [ ^g ]       Change the current trigonometrical base to
  217.                        gradients.
  218.  
  219.   Logical Operations.
  220.      AND  [ & ]        Perform a logical  AND  operation  on  the
  221.                        current entry and the next entry, treating
  222.                        both numbers as unsigned long integers.
  223.  
  224.      NOT  [ ~ ]        Perform the logical NOT operation  of  the
  225.                        current entry.
  226.  
  227.      OR   [ | ]        Perform a  logical  OR  operation  on  the
  228.                        current entry and the next entry, treating
  229.                        both numbers as unsigned long integers.
  230.  
  231.      XNOR [ n or N ]   Perform a logical XNOR  operation  on  the
  232.                        current entry and the next entry, treating
  233.                        both numbers as unsigned long integers.
  234.  
  235.      XOR  [ ^ ]        Perform a logical  XOR  operation  on  the
  236.                        current entry and the next entry, treating
  237.                        both numbers as unsigned long integers.
  238.  
  239.   Trigonometrical Operators.
  240.      SIN [ ^s ]        Return the trigonometric  sine,  arc  sine
  241.                        hyperbolic sine or inverse hyperbolic sine
  242.                        of the current display, depending upon the
  243.                        current  settings  of  the  hyperbolic and
  244.                        inverse function switches. The  result  is
  245.                        displayed  in  the  current  trigonometric
  246.                        units (degrees, radians or gradients).
  247.  
  248.      COS  [ ^c ]       Return  the  trigonometric   cosine,   arc
  249.                        cosine hyperbolic cosine or inverse hyper-
  250.                        bolic  cosine  of  the  current   display,
  251.                        depending upon the current settings of the
  252.                        hyperbolic and inverse function  switches.
  253.                        The  result  is  displayed  in the current
  254.                        trigonometric units (degrees,  radians  or
  255.                        gradients).
  256.  
  257.      TAN  [ ^t ]       Return  the  trigonometric  tangent,   arc
  258.  
  259.  
  260.  
  261. Sun Release 4.1   Last change: 13 December 1989                 4
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. CALCTOOL(1L)      MISC. REFERENCE MANUAL PAGES       CALCTOOL(1L)
  269.  
  270.  
  271.  
  272.                        tangent   hyperbolic  tangent  or  inverse
  273.                        hyperbolic tangent of the current display,
  274.                        depending upon the current settings of the
  275.                        hyperbolic and inverse function  switches.
  276.                        The  result  is  displayed  in the current
  277.                        trigonometric units (degrees,  radians  or
  278.                        gradients).
  279.  
  280.   Memory Register Operators.
  281.      RCL  [ r ]        Retrieve memory register n.   This  selec-
  282.                        tion  must  be  followed by a digit in the
  283.                        range 0 to 9 to indicate a  memory  regis-
  284.                        ter.
  285.  
  286.      STO  [ s ]        Store memory register  n.   This  must  be
  287.                        followed by a digit in the range 0 to 9 to
  288.                        indicate a memory register.  The  register
  289.                        number  may  be  preceded by an arithmetic
  290.                        operation (addition,  subtraction,  multi-
  291.                        plication  or division), in which case the
  292.                        specifed operation is carred  out  between
  293.                        the   displayed   entry   and   the  value
  294.                        currently in register n, and the result is
  295.                        placed in register n.
  296.  
  297.      EXCH [ ^e ]       Exchange the current display with the con-
  298.                        tents  of  memory register n.  This selec-
  299.                        tion must be followed by a  digit  in  the
  300.                        range  0 to 9, to indicate a memory regis-
  301.                        ter.
  302.  
  303.   Mathematical Operators.
  304.      %    [ % ]        Perform a percentage calculation using the
  305.                        last entry and the next entry.
  306.  
  307.      e^x  [ { ]        Return  e  raised  to  the  power  of  the
  308.                        current entry.
  309.  
  310.      10^x [ } ]        Return 10  raised  to  the  power  of  the
  311.                        current entry.
  312.  
  313.      y^x  [ Y ]        Take the last entry and raise  it  to  the
  314.                        power of the next entry.
  315.  
  316.      ln   [ N ]        Return  the  natural  logarithm   of   the
  317.                        current entry.
  318.  
  319.      log  [ G ]        Returns  the  base  10  logarithm  of  the
  320.                        current entry.
  321.  
  322.      SQRT [ S ]        Perform a square  root  operation  on  the
  323.                        current entry.
  324.  
  325.  
  326.  
  327. Sun Release 4.1   Last change: 13 December 1989                 5
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334. CALCTOOL(1L)      MISC. REFERENCE MANUAL PAGES       CALCTOOL(1L)
  335.  
  336.  
  337.  
  338.      1/x  [ R ]        Return the  value  of  1  divided  by  the
  339.                        current entry.
  340.  
  341.      x!   [ ! ]        Return the factorial of the current entry.
  342.                        Note  that  this  only  works for positive
  343.                        integers.
  344.  
  345.      x^2  [ @ ]        Return the square of the current entry.
  346.  
  347.   Number Manipulation Operators.
  348.      <    [ < ]        Left shift n places. This must be followed
  349.                        by a digit in the range 0 to 9 to indicate
  350.                        the number of places to shift.
  351.  
  352.      >    [ > ]        Right shift n places. This  must  be  fol-
  353.                        lowed  by  a  digit in the range 0 to 9 to
  354.                        indicate the number of places to shift.
  355.  
  356.      &32  [ [ ]        Truncate the current entry  to  a  32  bit
  357.                        unsigned integer (logical function).
  358.  
  359.      &16  [ ] ]        Truncate the given  number  to  a  16  bit
  360.                        unsigned integer (logical function).
  361.  
  362.      clr  [ Delete ]   Clear the calculator display.
  363.  
  364.      bsp  [ BackSpace ]
  365.                        Remove  the  rightmost  character  of  the
  366.                        current  entry  and  recalculate  the  the
  367.                        displayed value (note:  internal  accuracy
  368.                        is lost with this operation).
  369.  
  370.      INT  [ I ]        Return the integer portion of the  current
  371.                        entry.
  372.  
  373.      FRAC [ F ]        Return  the  fractional  portion  of   the
  374.                        current entry.
  375.  
  376.      ACC  [ A ]        Set accuracy. This must be followed  by  a
  377.                        digit  in the range 0 to 9 to indicate how
  378.                        many digits are to be displayed.
  379.  
  380.      CHS  [ C ]        Change the arithmetic sign of the  current
  381.                        entry.
  382.  
  383.      ABS  [ U ]        Return the absolute value of  the  current
  384.                        entry.
  385.  
  386.   Other keys.
  387.      MEM  [ M ]        Toggle the display of the  popup  register
  388.                        window.   Values  of the ten memory regis-
  389.                        ters are displayed in the current base, to
  390.  
  391.  
  392.  
  393. Sun Release 4.1   Last change: 13 December 1989                 6
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400. CALCTOOL(1L)      MISC. REFERENCE MANUAL PAGES       CALCTOOL(1L)
  401.  
  402.  
  403.  
  404.                        the current accuracy.
  405.  
  406.      FIX / SCI  [ ^n ] Toggles the numerical display mode between
  407.                        fixed  point and scientific notation. This
  408.                        affects the current display and  the  con-
  409.                        tents of the memory registers.
  410.  
  411.      CON  [ # ]        Retrieve and  display  constant  value  n.
  412.                        This selection must be followed by a digit
  413.                        in the range 0 to 9.
  414.                        The ten default constants are:
  415.  
  416.                        0 - kms per hour / miles per hour.
  417.                        1 - square root of 2.
  418.                        2 - e.
  419.                        3 - pi.
  420.                        4 - cms / inches.
  421.                        5 - degrees in a radian.
  422.                        4 - 2 ^ 20.
  423.                        6 - gms / oz.
  424.                        8 - kilojoules / British thermals.
  425.                        9 - cubic cms / cubic inches.
  426.  
  427.      HYP  [ h ]        Set or unset the hyperbolic function indi-
  428.                        cator.  This  switch  affects  the type of
  429.                        sine,  cosine  and  tangent  trigonometric
  430.                        functions performed.
  431.  
  432.      INV  [ i ]        Set or unset the inverse function  indica-
  433.                        tor. This switch affects the type of sine,
  434.                        cosine and tangent trigonometric functions
  435.                        performed.
  436.  
  437.      KEYS [ K ]        Toggle the labels on the calctool  buttons
  438.                        between mouse and keyboard equivalents.
  439.  
  440.      ?    [ ? ]        Display a help message  for  a  particular
  441.                        button.   First  select this key, then the
  442.                        key to be described.
  443.  
  444.      QUIT [q or Q]     Exit (without user verification).
  445.  
  446.      OFF  [ o ]        Change _c_a_l_c_t_o_o_l to an icon.
  447.  
  448. FILES
  449.      /usr/local/lib/calctool.help
  450.  
  451.      /usr/local/lib/calctool.ps
  452.  
  453.      ~/.calctoolrc
  454.  
  455.  
  456.  
  457.  
  458.  
  459. Sun Release 4.1   Last change: 13 December 1989                 7
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466. CALCTOOL(1L)      MISC. REFERENCE MANUAL PAGES       CALCTOOL(1L)
  467.  
  468.  
  469.  
  470. BUGS
  471.      Handling of errors generated by the mathematical routines is
  472.      poorly done.
  473.  
  474. AUTHOR
  475.      Rich Burridge,        Domain: richb@sunaus.oz.au
  476.      PHONE: +61 2 413 2666   Path: {uunet,mcvax,ukc}!munnari!sunaus.oz!richb
  477.      Original manual page modified by  R.  P.  C.  Rodgers,  UCSF
  478.      School of Pharmacy, San Francisco, CA 94143.
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525. Sun Release 4.1   Last change: 13 December 1989                 8
  526.  
  527.  
  528.  
  529.